package com.lee.forum.services;

import com.lee.forum.model.Article;
import com.lee.forum.model.PageResult;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: lishuo
 * Date: 2023-09-30
 * Time: 21:05
 */
public interface IArticleService {
    /**
     * 发布帖子
     * @param article 要发布的帖子
     */
    @Transactional
    // 当前方法中的执行过程会被事务管理起来
    void create (Article article);

    /**
     * 查询所有有效帖子列表
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据板块Id查询帖子列表
     * @param id
     * @return
     */
    List<Article> selectAllByBoardId(Long id);

    /**
     * 根据帖子Id查询帖子详情
     * @param id 帖子Id
     * @return
     */
    Article selectDetailById(Long id);

    /**
     * 根据帖子id查询当前帖子信息
     * @return
     */
    Article selectById(Long id);

    /**
     * 编辑帖子
     * @param id 帖子id
     * @param title 帖子标题
     * @param content 帖子正文
     */
    void modify(Long id,String title,String content);

    /**
     * 帖子点赞
     * @param id 帖子Id
     */
    void thumbsUpById (Long id);

    /**
     * 删除帖子
     * @param id 帖子id
     */
    @Transactional // 事务管理
    void deleteById(Long id);

    /**
     * 帖子回复数量 +1
     * @param id 帖子Id
     */
    void addOneArticleReplyCountById (Long id);

    /**
     * 根据用户Id查询帖子列表
     * @param userId 用户 id
     * @return
     */
    List<Article> selectByUserId(Long userId);

    /**
     * 从数据库中查询热度最高的10篇文章（初始化redis热榜使用）
     * @return
     */
    List<Article> selectTopnArticles(Integer n);

    /**
     * 分页获取文章列表
     * @param pIndex
     * @param pSize
     * @return
     */
    PageResult listByPage(Integer pIndex, Integer pSize, Long boardId);
}
